home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / icon tools / deft ii / docs / english / deft ii.guide (.txt) next >
Amigaguide Document  |  1996-04-07  |  35KB  |  624 lines

  1. @database "Deft II v1.6"
  2. @Index INDEXNODE
  3. @NODE Main "Deft II v1.6"
  4. ***************************************************************************
  5.                               @{b}Deft II@{ub} (v1.6)
  6.                    Utility to replace icon default tools
  7.                     Archive of November 1994, the 15th
  8.                      
  9.  Copyright 1994, @{b}Lionel Vintenat@{ub}
  10. ***************************************************************************
  11. @{" Introduction         "    Link Introduction        }
  12. @{" Installation         "    Link Installation        }
  13. @{" Using                "    Link Utilisation        }
  14. @{" The GUI              "    Link Interface            }
  15. @{" The ARexx port       "    Link ARexx                }
  16. @{" The sources          "    Link Sources            }
  17. @{" Bugs                 "    Link Bugs                }
  18. @{" History              "    Link Historique            }
  19. @{" To do                "    Link A_faire            }
  20. @{" Distribution         "    Link Distribution        }
  21. @{" The author           "    Link Auteur                }
  22. @{" The acknowledgements "    Link Remerciements        }
  23. @ENDNODE
  24. -------------------------------------------------------------------------------
  25. @NODE Introduction "Introduction"
  26.     Let's have a little trip in the past. Some times ago, I found on a fish
  27. disk an excellent little program named Deft (
  28.  1992, Gary Smith). Its goal
  29. was vey simple : change the icon default tools. Let's take a using example.
  30. Suppose that you get used to reading your documentations with More program.
  31. In this case, all your documentation icons have as default tool something
  32. like "SYS:Utilities/more". And then, a nice day, you discover the fabulous
  33. Most. And of course, starting this moment, you don't want to hear about
  34. More ever (and I agree ! :)). But change all your default tool fields of
  35. your documentation icons may be a HUDGE task if your hard drive is a big
  36. one. It's at his point that Deft comes up. You give it a path, an old
  37. default tool, a new default tool, and goooo, it makes all the replacements
  38. on your hard drive. Briefly, Deft is (for my point of view) a typical PD
  39. program : too small to be commercial, but genius for the idea, and
  40. dramatically useful (we don't need it often, but when we need it, we are
  41. REALLY happy to have it !!!).
  42.     You probably guess it, Deft II is a new version (starting from nothing
  43. as I hadn't Deft sources) of Deft. This program seemed to be undevelopped
  44. for a long a time, so I allow myself to rewrite it, adding -I hope- a lot
  45. of enhancements, namely :
  46.         - a MUI GUI with all the consequent convenience for the user
  47. (keyboard shortcuts, appwindows, etc)
  48.         - multi-paths handling for scanning
  49.         - multi-default tools for replacing
  50.         - wildcard using for the default tools to replace
  51.         - preferences saving
  52.         - ARexx support
  53.         - online help
  54.     About this documentation reading, read completely the chapter @{" using " Link Utilisation}.
  55. All that you need to know is there. The chapter about @{" the GUI " Link Interface} is in
  56. fact used for the online help, and thus, may be used as a reference
  57. document. Finally, if you are an ARexx wizard, have a look on the chapter
  58. @{" ARexx " Link ARexx}.
  59. WARNIGN : Deft II needs 2.0 Workbench or newer to run, and MUI v2.2
  60. properly installed.
  61. @ENDNODE
  62. -------------------------------------------------------------------------------
  63. @NODE Installation "Installation"
  64.     If you have the Installer program, just let you guide !
  65.     If it isn't the case, don't panic ! Deft II is a very simple program
  66. which can be installed easily and without pain manually :
  67. 1) Copy all the files "Deft II", "Deft II.info", "Deft II.prefs",
  68. "Deft II.guide" (the one which corresponds to your language), and
  69. "Deft II.guide.info" inside a SAME directory of your choice.
  70. 2) Copy "DeftII_Test.rexx" inside REXX:.
  71. 3) Copy the "DeftII.catalog" file which corresponds to your language if
  72. it is available and if your Workbench supports localization (normally only
  73. Workbench versions newer or equal to 2.1 support it) inside the system
  74. directory "LOCALE:Catalogs/votre_langue/".
  75. 4) (optional) Copy the "Sources/" directory where you want.
  76. @ENDNODE
  77. -------------------------------------------------------------------------------
  78. @NODE Utilisation "Using"
  79.     Let's see first a little @{" tutorial "    Link Didacticiel} about Deft II using.
  80. Then let's follow with this fondamental and serious question : 
  81. @{" But how does the author himself use his program ? "    Link Mon_Utilisation} :)
  82. @ENDNODE
  83. -------------------------------------------------------------------------------
  84. @NODE Didacticiel "Tutorial"
  85.     Open the unique window of Deft II. This one can be split into three
  86. parts :
  87.         - on the left the 'Default tools' group
  88.         - on the right the 'Paths' group
  89.         - on the bottom the text gadget 'File' and the 'Deft II controls'
  90. group
  91.     The 'Default tools' group is used to define which default tools Deft II
  92. will have to replace, and by which new default tools it will have to
  93. replace them.
  94.     Each old/new default tool pair is displayed in this order inside the
  95. list. To enter such a pair, use the two string gadgets 'Old' and 'New'.
  96. Note that the pair is enregistered when (and only when) you strike the
  97. enter key inside the text gadget 'New'. Note also that Deft II doesn't
  98. accept a pair if the old default tool is empty or if it already exists a
  99. pair with the same old default tool. But it's possible to enter a pair with
  100. the new default tool empty. This pair will be then displayed in italic
  101. inside the list to signal you that the definition of this pair is
  102. incomplete.
  103.     The old default tool may have wildcars (not the new one of course !).
  104. For instance, "#?more#?" is a possible old default tool. During the
  105. replacement stage, Deft II will search among all the project icons located
  106. inside the paths to scan if one has a default tool which matches this
  107. pattern, and will perform, in case of matching, the replacement. You can
  108. thus replace very easily the "c/more", "c:more" and other ":c/MuchMore" by
  109. "c:Most" ! Better, you can without any trouble ask Deft II to replace all
  110. the "#?guide#?" by "c:AmigaGuide" because Deft II check before a
  111. replacement that it isn't going to replace a string by itself. So, a
  112. default tool like "C:amigaguide" (note that Deft II is case insensitive),
  113. won't be replaced whereas ":c/AmigaGuide" will.
  114.     The popup gadget on the right of the string gadget 'New' opens a little
  115. list where all the new default tools already entered in Deft II are : you
  116. can thus select one without needing to type it again. But the first time,
  117. you can use the popfile gadget on the right of the popup gadget. This opens
  118. a file requester where you can choose a new default tool.
  119.     Double-clicking on a pair in the list enables you to edit it.
  120.     You can drop on the list and on the 'Old' string of the 'Default tools'
  121. group some project icons. If you do, the default tools of these icons will
  122. be immediately added (if they weren't already there of course) in the list.
  123. In these case, they will appear in italic because they haven't yet a
  124. corresponding default tool.
  125.     Finally, you can drop on the 'New' string of the 'Default tools' group
  126. a tool icon. If you do, this one will appear in this string. This does the
  127. same as the "popfile" gadget on the right of this string.
  128.     The 'Paths' group is used to define the paths to recursively scan
  129. during the replacement stage, paths which are displayed in a list. If you
  130. drop an icon to this group, the path of the file or of the drawer is added
  131. to the paths list. Double-clicking on a path in the list enables you to
  132. edit it.
  133.     Finally, you can use the 'Deft II controls' group to run the default
  134. tools replacement stage (button 'GO !!!'), to stop the replacement stage at
  135. any moment (button 'Stop') or to save the preferences (button 'Save
  136. prefs'), preferences which hold the two list contents. During the
  137. replacement stage, Deft II displays inside the text gadget 'File' all the
  138. files whose icon is modified by Deft II.
  139. @ENDNODE
  140. -------------------------------------------------------------------------------
  141. @NODE Mon_Utilisation "How I use myself Deft II..."
  142.     I personally configured Deft II to use it in the case of a replacement
  143. on my hard drive. In other words, the preferences I saved hold all my hard
  144. drive partitions inside the paths list.
  145.     However a frequent case when the default tool replacement is needed
  146. appears during a new program test (thing I usually do in RAM: or SD0:).
  147. Indeed, it's often the case that, when I click on the installation icon or
  148. on the documentation icon, the Workbench doesn't find the right default
  149. tool. To solve this problem, I run before starting my tests Deft II by a
  150. hotkey from ToolManager. Deft II starts then iconified (thing to configure
  151. with MUI-Prefs if you are a register user). Then for each new test in RAM:
  152. or in SD0: (i.e. for each new archive unarchived), I run, always with an
  153. hotkey from ToolManager (I love this program :)), a little ARexx script,
  154. "DeftII_test.rexx". This one clears the path list of Deft II replacing them
  155. by "RAM: and "SD0:", and just after runs the replacement stage (so located
  156. in RAM: and SD0:). Once this one finished, it re-builds the path list as it
  157. found it at starting. In other words, thanks to this little ARexx script
  158. and to ToolManager, I can perform a very fast replacement (RAM operation
  159. and Deft II is always iconified) of the default tools for each new archive
  160. during its test stage, and all this without loosing my configuration of
  161. Deft II, this last one sticked to my hard drive partitions.
  162.     So I advise you to try this ARexx script, even if you aren't a wizard
  163. of this language (I put all the required comments in order you can adapt it
  164. to your needs). For my point of view, it completely automates Deft II
  165. using.
  166.     To help you, I provided in this archive my own Deft II preferences
  167. file.
  168. @ENDNODE
  169. -------------------------------------------------------------------------------
  170. @NODE Interface "The GUI"
  171.         @{" The 'Default tools' group    "    Link gr_default_tools    }
  172.         @{" The 'Paths' group            "    Link gr_paths            }
  173.         @{" The text gadget 'File'       "    Link tx_info            }
  174.         @{" The 'Deft II controls' group "    Link gr_controls        }
  175. @ENDNODE
  176. -------------------------------------------------------------------------------
  177. @NODE gr_default_tools "The 'Default tools' group"
  178.     Manages the old/new default tool pairs.
  179.     If you drop a project icon on the list or on the 'Old' string of this
  180. group, its default tool will be automagically added to this list (if it
  181. isn't already there of course) as "old default tool". It hasn't yet a
  182. corresponding "new default tool".
  183.     If you drop a tool icon on the 'New' string of this group, this one
  184. will appear in this string.
  185.         @{" The list                   "    Link lv_default_tools    }
  186.         @{" The string 'Old'           "    Link stR_old_def_tool    }
  187.         @{" The popobject gadget 'New' "    Link po_new_def_tool    }
  188.         @{" The 'Delete' button        "    Link bt_delete_def_tool    }
  189. @ENDNODE
  190. -------------------------------------------------------------------------------
  191. @NODE lv_default_tools "The list"
  192.     Displays all the old/new default tool pairs known by Deft II. If a
  193. pair hasn't a new default tool, it is displayed in italic.
  194.     Double-click on a pair in this list to edit it.
  195. @ENDNODE
  196. -------------------------------------------------------------------------------
  197. @NODE stR_old_def_tool "The string 'Old'"
  198.     Enter in this string an old default tool to replace.
  199. @ENDNODE
  200. -------------------------------------------------------------------------------
  201. @NODE po_new_def_tool "The popobject gadget 'New'"
  202.     Enter in this string by which new default tool Deft II must replace the
  203. associated old default tool. Strike the ENTER key inside this string to
  204. validate the current edited pair.
  205.     If you click on the popup image on the right of the string, it opens a
  206. list of the new default tools already entered in Deft II. Double-click on
  207. one entry of this list to select it.
  208.     If you click on the popfile image on the right of the popup image, this
  209. opens a file requester to choose a new default tool to put in the string.
  210. @ENDNODE
  211. -------------------------------------------------------------------------------
  212. @NODE bt_delete_def_tool "The 'Delete' button"
  213.     Deletes the active pair from the list.
  214. @ENDNODE
  215. -------------------------------------------------------------------------------
  216. @NODE gr_paths "The 'Paths' group"
  217.     Manages all the paths to scan.
  218.     If you drop an icon inside this group, its path will be automagically
  219. added to this list (if it isn't already there of course).
  220.         @{" The list            "    Link lv_paths        }
  221.         @{" The popasl gadget   "    Link pa_path        }
  222.         @{" The 'Delete' button "    Link bt_delete_path    }
  223. @ENDNODE
  224. -------------------------------------------------------------------------------
  225. @NODE lv_paths "The list"
  226.     Displays all the paths known by Deft II.
  227.     Double-click on a path in this list to edit it.
  228. @ENDNODE
  229. -------------------------------------------------------------------------------
  230. @NODE pa_path "The popasl gadget"
  231.     Enter here a path to add to the list. You can either type manually this
  232. new path, or choose it with a file requester by clicking on the popasl
  233. gadget on the right of this string.
  234. @ENDNODE
  235. -------------------------------------------------------------------------------
  236. @NODE bt_delete_path "The 'Delete' button"
  237.     Deletes the active path from the list.
  238. @ENDNODE
  239. -------------------------------------------------------------------------------
  240. @NODE tx_info "The text gadget 'File'"
  241.     During the replacement stage, displays all the files whose icon is
  242. modified by Deft II.
  243. @ENDNODE
  244. -------------------------------------------------------------------------------
  245. @NODE gr_controls "The 'Deft II controls' group"
  246.         @{" The 'GO !!!' button     "    Link bt_go            }
  247.         @{" The 'Stop' button       "    Link bt_stop        }
  248.         @{" The 'Save prefs' button "    Link bt_save_prefs    }
  249.         @{" The 'About' button      "    Link bt_about        }
  250.         @{" The 'Quit' button       "    Link bt_quit        }
  251. @ENDNODE
  252. -------------------------------------------------------------------------------
  253. @NODE bt_go "The 'GO !!!' button"
  254.     Starts the replacement stage : Deft II recursively scan all the given
  255. paths, and change the "default tool" field of each icon where this field
  256. mathes an "old default tool" to the "new default tool" associated.
  257.     The old default tool may be an AmigaDos pattern and Deft II checks
  258. before the replacement that the current "default tool" field isn't the same
  259. than the "new default tool" associated.
  260. @ENDNODE
  261. -------------------------------------------------------------------------------
  262. @NODE bt_stop "The 'Stop' button"
  263.     Enables you to stop a any moment the replacement stage.
  264.     Without effect in the other cases.
  265. @ENDNODE
  266. -------------------------------------------------------------------------------
  267. @NODE bt_save_prefs "The 'Save prefs' button"
  268.     Saves Deft II preferences in the current path under the name
  269. "Deft II.prefs".
  270. @ENDNODE
  271. -------------------------------------------------------------------------------
  272. @NODE bt_about "The 'About' button"
  273.     Prompts a requester which talks you about me :).
  274. @ENDNODE
  275. -------------------------------------------------------------------------------
  276. @NODE bt_quit "The 'Quit' button"
  277.     Quits Deft II.
  278.     If a file requester is still opened, Deft II will complain.
  279.     If the preferences have been modified without being saved, Deft II will
  280. ask you confirmation.
  281. @ENDNODE
  282. -------------------------------------------------------------------------------
  283. @NODE ARexx "The ARexx port"
  284.     The Arexx port of Deft II is named DEFT_II.n where n is 1, 2, etc
  285. according to the number of Deft II you have run. The commands of this port
  286. are the following :
  287. @{" quit       FORCE/S "    Link ARexx_MUI    }
  288. @{" activate           "    Link ARexx_MUI    }
  289. @{" deactivate         "    Link ARexx_MUI    }
  290. @{" show               "    Link ARexx_MUI    }
  291. @{" hide               "    Link ARexx_MUI    }
  292. @{" info       ITEM/A  "    Link ARexx_MUI    }
  293. @{" help       FILE/A  "    Link ARexx_MUI    }
  294. @{" number_paths                                  "    Link ARexx_number_paths            }
  295. @{" number_default_tools                          "    Link ARexx_number_default_tools    }
  296. @{" add_path             PATH/A                   "    Link ARexx_add_path                }
  297. @{" add_default_tool     OLD/A,NEW/A              "    Link ARexx_add_default_tool        }
  298. @{" delete_path          PATH/N/A                 "    Link ARexx_delete_path            }
  299. @{" delete_default_tool  DEFAULT_TOOL=DT/N/A      "    Link ARexx_delete_default_tool    }
  300. @{" get_path             PATH/N/A                 "    Link ARexx_get_path                }
  301. @{" get_old_default_tool OLD_DEFAULT_TOOL=ODT/N/A "    Link ARexx_get_old_default_tool    }
  302. @{" get_new_default_tool NEW_DEFAULT_TOOL=NDT/N/A "    Link ARexx_get_new_default_tool    }
  303. @{" save_prefs                                    "    Link ARexx_save_prefs            }
  304. @{" go                                            "    Link ARexx_go                    }
  305. @{" loose_modifications                           "    Link ARexx_loose_modifications    }
  306.     Note that none of the Deft II own ARexx commands prompt the apparition
  307. of requesters inside Deft II; this sometimes differs from the same action
  308. this time called from the GUI (example : "'go' ARexx command and 'GO !!!'
  309. button).
  310. @ENDNODE
  311. -------------------------------------------------------------------------------
  312. @NODE ARexx_MUI "Basic MUI ARexx command"
  313.     This ARexx command is always present in all the MUI applications. So
  314. refer you to the MUI (user) documentation for further details.
  315. @ENDNODE
  316. -------------------------------------------------------------------------------
  317. @NODE ARexx_number_paths "ARexx command 'number_paths'"
  318.     Returns the number of paths present in the list of the 'Paths' group.
  319. @ENDNODE
  320. -------------------------------------------------------------------------------
  321. @NODE ARexx_number_default_tools "ARexx command 'number_default_tools'"
  322.     Returns the number of old/new default tool pairs present in the list of
  323. the 'Default tools' group.
  324. @ENDNODE
  325. -------------------------------------------------------------------------------
  326. @NODE ARexx_add_path "ARexx command 'add_path'"
  327.     Adds the given path in the list of the 'Paths' group.
  328.     A return code of 10 indicates that the given path was already there.
  329. @ENDNODE
  330. -------------------------------------------------------------------------------
  331. @NODE ARexx_add_default_tool "ARexx command 'add_default_tool'"
  332.     Adds the given old/new default tool pair to the list of the 'Default
  333. tools' group.
  334.     A return code of 10 indicates that the given pair was already there.
  335. @ENDNODE
  336. -------------------------------------------------------------------------------
  337. @NODE ARexx_delete_path "ARexx command 'delete_path'"
  338.     Deletes from the list of the 'Paths' group the path whose number is
  339. given as parameter (the numbering starts from 0).
  340.     A return code of 10 indicates that the given number doesn't correspond
  341. to any path (number too large or negative).
  342. @ENDNODE
  343. -------------------------------------------------------------------------------
  344. @NODE ARexx_delete_default_tool "ARexx command 'delete_default_tool'"
  345.     Deletes from the list of the 'Default tools' group the old/new default
  346. tool pair whose number is given as parameter (the numbering starts from 0).
  347.     A return code of 10 indicates that the given number doesn't correspond
  348. to any pair (number too large or negative).
  349. @ENDNODE
  350. -------------------------------------------------------------------------------
  351. @NODE ARexx_get_path "ARexx command 'get_path'"
  352.     Returns the path whose number is given as parameter (the numbering
  353. starts from 0).
  354.     A return code of 10 indicates that the given number doesn't correspond
  355. to any path (number too large or negative).
  356. @ENDNODE
  357. -------------------------------------------------------------------------------
  358. @NODE ARexx_get_old_default_tool "ARexx command 'get_old_default_tool'"
  359.     Returns the old default tool whose number is given as parameter (the
  360. numbering starts from 0).
  361.     A return code of 10 indicates that the given number doesn't correspond
  362. to any old default tool (number too large or negative).
  363. @ENDNODE
  364. -------------------------------------------------------------------------------
  365. @NODE ARexx_get_new_default_tool "ARexx command 'get_new_default_tool'"
  366.     Returns the new default tool whose number is given as parameter (the
  367. numbering starts from 0).
  368.     A return code of 10 indicates that the given number doesn't correspond
  369. to any new default tool (number too large or negative).
  370. @ENDNODE
  371. -------------------------------------------------------------------------------
  372. @NODE ARexx_save_prefs "ARexx command 'save_prefs'"
  373.     Makes Deft II save your preferences.
  374.     A return code of 50 indicates that an error occured during the
  375. preference saving, and that this one doesn't happen correctly.
  376. @ENDNODE
  377. -------------------------------------------------------------------------------
  378. @NODE ARexx_go "ARexx command 'go'"
  379.     Runs the replacement stage of the default tools according to the
  380. current preferences.
  381.     A return code of 10 indicates that some incorrect paths were paths
  382. during this stage, and that these ones were removed from the list of the
  383. 'Paths' group. 5 is added to this return code if this stage was stopped by
  384. the user before its normal end. Finally, 100 is added to this return code
  385. if a serious error has prevented Deft II from the access of a file or a
  386. directory. In this case, Deft II immediately stops its activities while
  387. freeing all the ressources it owns.
  388.     To sum up, the possible return codes are 5, 10, 15, 100 and 110.
  389. @ENDNODE
  390. -------------------------------------------------------------------------------
  391. @NODE ARexx_loose_modifications "ARexx command 'loose_modifications'"
  392.     Makes Deft II forget that some modifications were made to the
  393. preferences. This allows doing such modifications from a script but without
  394. the user being annoyed by a confirmation requester when he will want to
  395. quit Deft II.
  396. @ENDNODE
  397. -------------------------------------------------------------------------------
  398. @NODE Sources "The sources"
  399.     All the sources of Deft II are provided. So you can recompile this
  400. program without any trouble. For this, you need Mac2E v4.0+ and autobuild
  401. v1.0+ in addition of Amiga E v3.0+. If you followed the installation
  402. instructions of these programs, the command "autobuild" would be enough.
  403.     However don't forget that modifications to the files of this
  404. distribution is only allowed for your strictly personal usage (see
  405. @{" distribution " Link Distribution}) ! If you find a bug and fix it, please, write
  406. to me in order I make a new version, thanks.
  407.     The main reason for which I provided all the sources is of course that
  408. they can be used as examples for other programers. I myself took a lot of
  409. benefit from other programmer sources, so I hope that the chain will
  410. continue :).
  411.     Finally, I precise that I joined the ".cd" and ".ct" files to let you
  412. re-build the catalog for your language. If you make such a catalog, don't
  413. forget to send it to me in order I can include it in the future released
  414. versions, thanks.
  415. @ENDNODE
  416. -------------------------------------------------------------------------------
  417. @NODE Bugs "Bugs"
  418.     None known.
  419. @ENDNODE
  420. -------------------------------------------------------------------------------
  421. @NODE Historique "History"
  422. @{b}Version 1.0@{ub} :  - First released version
  423. @{b}Version 1.1@{ub} :  - re-programmed for Amiga E v3.0a
  424.                 - localization problem resolved (before some strings didn't
  425.                     appear when default English language was used)
  426. @{b}Version 1.2@{ub} :  - optimisation of the replacement stage with the ExAll()
  427.                     function => 4 times faster !
  428.                 - in case of memory starvation during this stage, Deft II
  429.                     now frees all the allocated ressources
  430. @{b}Version 1.3@{ub} :  - addition of the popfile gadget to choose a new default
  431.                     tool
  432.                - it's possible to drop on the 'New' string a tool icon to
  433.                     put this tool in this string
  434.                - 2nd released version
  435. @{b}Version 1.4@{ub} :  - german catalog added
  436.                - recompiled with Amiga E v3.0b
  437.                - better localization handling (internal)
  438.                - more general preferences file
  439. @{b}Version 1.5@{ub} :  - enforcer hits removed : nothing serious (only reads) but
  440.                     <<nothing should be causing enforcer hit>>
  441.                     (enforcer readme)
  442. @{b}Version 1.6@{ub} :  - enforcer hits removed (grrrr I hope they were the last
  443.                     ones this time...) : still nothing serious but...
  444.                - bug fixed : at startup time, Deft II could hang when an
  445.                     MUI error occured
  446.                - recompiled with Amiga E v3.0b
  447. @ENDNODE
  448. -------------------------------------------------------------------------------
  449. @NODE A_Faire "To do"
  450.     I have in mind to write a commodity in addition of Deft II which would
  451. patch the system to change in real time the default tools. Of course, this
  452. one would use the preferences de Deft II. But for the moment, it's just an
  453. idea, not a project.
  454.     Apart this I don't see anything to add to Deft II, except fixing bugs
  455. of course. But I'm opened to every reasonable suggestion (see
  456. @{" the author " Link Auteur}).
  457. @ENDNODE
  458. -------------------------------------------------------------------------------
  459. @NODE Distribution "Distribution"
  460.     @{b} All the files of this distribution stay under the copyright of the
  461. author (Lionel Vintenat)@{ub}. You are allowed to modify them only for your
  462. STRICTLY PERSONAL usage.
  463.     The only exceptions are the "Readme.mui" file and the icons.
  464.     This archive can be @{b}freely distributed@{ub} by any thinkable ways
  465. (ftp server, BBS, public domain collection, etc), as long as the two
  466. following conditions are respected :
  467.     1) @{b}No person gains ANY benefit from this distribution@{ub}. In
  468. particular, if Deft II is spread on a floppy disk, this one can't be sold
  469. for more than 4$ US (or equivalent), and if it is spread on a CDROM, this
  470. one can't be sold for more than 30$ US (or equivalent). No other type of
  471. sale (with benefit) can be made IN ANY CASES without the author's
  472. authorization. The only exceptions are the Fred Fish's and aminet CDROMs,
  473. who they (and only them !) can include Deft II in their collections without
  474. asking me the permission first. In particular, this excludes DEFINITIVELY
  475. to France Festival Distribution the right to distribute Deft II (I insist
  476. HEAVILY on this point...). But maybe this won't annoy too much Mr Serge
  477. Hammouche, who doesn't hesitate to call (openly on some French nets) French
  478. PD programers incapable...
  479.     2) @{b}This archive is distributed IN IT'S ENTIRETY, and without
  480. MODIFICATIONS compared to the original version on aminet@{ub}. This means
  481. in particular that if you make a translation of the documentation or of the
  482. catalog in a new language, or if you fix some bugs and re-compile the
  483. executable, you MUST send them to me in order I EVENTUALLY (pretty sure in
  484. fact for translations) redistribute a new version of this program. The
  485. file structure this archive must have is given in the "ReadMe.first" file
  486. of this distribution.
  487.     Any distribution of Deft II which doesn't respect the two previous
  488. conditions without my authorization is @{b}ILLEGAL@{ub}.
  489.     All the begining of this paragraph may seem very strict, even close to
  490. the paranoia, but knowing the dubious practices of people like Serge
  491. Hammouche who sells for HUDGE prices (under translation excuse) some freely
  492. distribuable softwares without even informing the authors, I think it's
  493. necessary to protect my rights. I make programs for my pleasure without any
  494. claim to earn money, and I'm happy if they may help other persons, but that
  495. some people make money from my work : NO ! The previous limitations doesn't
  496. aim in any way serious people like Fred Fish, the Montr
  497. al Amiga Club, the
  498. aminet system operators, or all the clubs of fascinated people, who, them,
  499. really support the Amiga domain public. They only aim the organizations
  500. with discutable pratices like France Festival Distribution.
  501.     Moreover, I cannot be held responsible for the use of this program and
  502. any damages that it may cause directly or not. I want this to be clear :
  503. @{b}YOU USE IT AT YOUR OWN RISK !@{ub}
  504.     However, I think I tested and I made people test it enough to say that
  505. it doesn't contain any serious bug.
  506.     Finally, this program is distributed under @{b}giftware@{ub} concept.
  507. In other words, you must send me a gift if you use Deft II ! :)
  508.     Indeed, I make programs for my pleasure and by need. My goal is
  509. certainly not to earn money with. However to distribute a program ask for
  510. some extra work (documentations, installer script, etc), so I'd like to
  511. receive a feedback from those who will use Deft II. In fact, any sign of
  512. life will be VERY appreciated, even a simple e-mail or a postcard. What I
  513. am the more interested in is contact with other persons. But to help you to
  514. choose my gift, here are some suggestions :) :
  515.         - a (free !) registration to a shareware program
  516.         - one of your realizations (program, module, animation, picture,
  517. etc) if it isn't easy to retrieve it from aminet
  518.         - some sourves
  519.         - some E, C or assembly sources which are closed to the
  520. programation of the system, or even False or BrainFuck sources (they can
  521. be closed of anything, provided they work ! :))
  522.         - some money, hummmm, why not ? :)
  523.         - your old 1.3 RKM (or better 2.0)
  524.     I insist on the fact that it's very frustrating to make the effort to
  525. put his program in the freely distribuable domain wihtout never receiving
  526. any feedback, just guessing that some people use your program ! So please
  527. support the giftware concept, everybody break even : the author is happy to
  528. receive a feedback, and it costs almost nothing to the users.
  529. @ENDNODE
  530. -------------------------------------------------------------------------------
  531. @NODE Auteur "The author"
  532.     You can reach me by snail-mail at my family address :
  533.             @{b}Lionel Vintenat@{ub}
  534.             3 impasse Boileau
  535.             Lotissement Les Termes
  536.             87270 COUZEIX
  537.             FRANCE
  538.     You can also reach me on the internet. My e-mail address is
  539. @{b}vintenat@reseau.onecert.fr@{ub}. This address will remain reliable until
  540. August 1995 included. I prefer by far that you write to me by e-mail
  541. than by snail mail.
  542. @ENDNODE
  543. -------------------------------------------------------------------------------
  544. @NODE Remerciements "The acknowledgements"
  545.     To make this program, I used the following softwares :
  546.         - @{b}Amiga E v3.0e@{ub} by Wouter van Oortmerssen
  547.         - @{b}MUI v2.2@{ub} by Stefan Stuntz
  548.         - @{b}MUIBuilder v2.0
  549. @{ub} by Eric Totel
  550.         - @{b}Mac2E v4.0@{ub} by ... euh ... myself !
  551.         - @{b}AutoBuild v1.0@{ub} by Jan Hendrik Schulz
  552.         - @{b}FlexCat v1.4@{ub} by Jochen Wiedmann
  553.         - @{b}Iconian v1.98
  554. @{ub} by Chad Randall
  555.     All helped me, and not to say that were absolutely required, so I
  556. thanks their authors.
  557.     A very special BIG thank you to :
  558.         - @{b}Gary Smith@{ub} (I never meet him, but who knows with the
  559. magic internet) for making Deft : he is the person to congratulate for the
  560. genious idea of this program
  561.         - l'@{b}Amiga@{ub} to be the best home computer
  562.         - @{b}Wouter van Oortmerssen@{ub} for his work in the field of
  563. compilers (try his FALSE, guaranteed surprise!) in general and for
  564. @{b}Amiga E@{ub} in particular
  565.         - all those on the @{b}French Amiga Mailing list@{ub} who have helped me
  566.         - all those who write public domain programs in general
  567.         - @{b}Boris Jakubaschk@{ub} for his comments and for the German catalog
  568.         - @{b}Xavier Billault@{ub} for his beta-testing (online !) et his
  569. suggestions
  570.         - @{b}Patrick Tremisi@{ub} for his beta-testing and his suggestions
  571.         - @{b}Vincent Thomas@{ub} for his beta-testing and his suggestions
  572.     Finally, thank you to all those who will signal me @{" bugs " Link Bugs}
  573. or suggestions, or who will send me corrections or translations of this
  574. documentation (see @{" the author " Link Auteur}).
  575.     Good PD and ...
  576.         @{b}NEVER FORGET, ONLY AMIGA MAKES IT POSSIBLE !@{ub}
  577. @ENDNODE
  578. @NODE INDEXNODE "Index"
  579. @{"ARexx command 'add_default_tool'" link "ARexx_add_default_tool"}
  580. @{"ARexx command 'add_path'" link "ARexx_add_path"}
  581. @{"ARexx command 'delete_default_tool'" link "ARexx_delete_default_tool"}
  582. @{"ARexx command 'delete_path'" link "ARexx_delete_path"}
  583. @{"ARexx command 'get_new_default_tool'" link "ARexx_get_new_default_tool"}
  584. @{"ARexx command 'get_old_default_tool'" link "ARexx_get_old_default_tool"}
  585. @{"ARexx command 'get_path'" link "ARexx_get_path"}
  586. @{"ARexx command 'go'" link "ARexx_go"}
  587. @{"ARexx command 'loose_modifications'" link "ARexx_loose_modifications"}
  588. @{"ARexx command 'number_default_tools'" link "ARexx_number_default_tools"}
  589. @{"ARexx command 'number_paths'" link "ARexx_number_paths"}
  590. @{"ARexx command 'save_prefs'" link "ARexx_save_prefs"}
  591. @{"Basic MUI ARexx command" link "ARexx_MUI"}
  592. @{"Bugs" link "Bugs"}
  593. @{"Deft II v1.3" link "Main"}
  594. @{"Distribution" link "Distribution"}
  595. @{"History" link "Historique"}
  596. @{"How I use myself Deft II..." link "Mon_Utilisation"}
  597. @{"Installation" link "Installation"}
  598. @{"Introduction" link "Introduction"}
  599. @{"The 'About' button" link "bt_about"}
  600. @{"The 'Default tools' group" link "gr_default_tools"}
  601. @{"The 'Deft II controls' group" link "gr_controls"}
  602. @{"The 'Delete' button" link "bt_delete_def_tool"}
  603. @{"The 'Delete' button" link "bt_delete_path"}
  604. @{"The 'GO !!!' button" link "bt_go"}
  605. @{"The 'Paths' group" link "gr_paths"}
  606. @{"The 'Quit' button" link "bt_quit"}
  607. @{"The 'Save prefs' button" link "bt_save_prefs"}
  608. @{"The 'Stop' button" link "bt_stop"}
  609. @{"The acknowledgements" link "Remerciements"}
  610. @{"The ARexx port" link "ARexx"}
  611. @{"The author" link "Auteur"}
  612. @{"The GUI" link "Interface"}
  613. @{"The list" link "lv_default_tools"}
  614. @{"The list" link "lv_paths"}
  615. @{"The popasl gadget" link "pa_path"}
  616. @{"The popobject gadget 'New'" link "po_new_def_tool"}
  617. @{"The sources" link "Sources"}
  618. @{"The string 'Old'" link "stR_old_def_tool"}
  619. @{"The text gadget 'File'" link "tx_info"}
  620. @{"To do" link "A_Faire"}
  621. @{"Tutorial" link "Didacticiel"}
  622. @{"Using" link "Utilisation"}
  623. @endnode
  624.